home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / ln.man < prev    next >
Encoding:
Text File  |  1990-02-21  |  2.7 KB  |  67 lines

  1.  
  2.  
  3.  
  4. LN                        User Commands                        LN
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      ln - make links
  10.  
  11. SSYYNNOOPPSSIISS
  12.      llnn [ --ss || --rr ] sourcename [ targetname ]
  13.      llnn [ --ss || --rr ] sourcename1 sourcename2 [ sourcename3 ... ]
  14.      targetdirectory
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      A link is a directory entry referring to a file; the same
  18.      file (together with its size, all its protection informa-
  19.      tion, etc.) may have several links to it.  There are three
  20.      kinds of links: hard links, symbolic links, and remote
  21.      links.
  22.  
  23.      By default _l_n makes hard links.  A hard link to a file is
  24.      indistinguishable from the original directory entry; any
  25.      changes to a file are effective independent of the name used
  26.      to reference the file.  Hard links may not refer to direc-
  27.      tories (unless the proper incantations are supplied) and may
  28.      not span file systems.
  29.  
  30.      The --ss option causes _l_n to create symbolic links.  A sym-
  31.      bolic link contains the name of the file to which it is
  32.      linked.  The referenced file is used when an _o_p_e_n(2) opera-
  33.      tion is performed on the link.  A _s_t_a_t(2) on a symbolic link
  34.      will return the linked-to file; an _l_s_t_a_t(2) must be done to
  35.      obtain information about the link.  The _r_e_a_d_l_i_n_k(2) call may
  36.      be used to read the contents of a symbolic link.  Symbolic
  37.      links may span file systems and may refer to directories.
  38.  
  39.      Given one or two arguments, _l_n creates a link to an existing
  40.      file _s_o_u_r_c_e_n_a_m_e.  If _t_a_r_g_e_t_n_a_m_e is given, the link has that
  41.      name; _t_a_r_g_e_t_n_a_m_e may also be a directory in which to place
  42.      the link; otherwise it is placed in the current directory.
  43.      If only the directory is specified, the link will be made to
  44.      the last component of _s_o_u_r_c_e_n_a_m_e.
  45.  
  46.      Given more than two arguments, _l_n makes links in _t_a_r_g_e_t_-
  47.      _d_i_r_e_c_t_o_r_y to all the named source files.  The links made
  48.      will have the same name as the files being linked to.
  49.  
  50.      The --rr option causes _l_n to create remote links at the given
  51.      location.  Remote links are special files that identify
  52.      places in Sprite where file system domains are attached to
  53.      their parent domains.  The source of a remote link must be
  54.      an absolute path.  In the normal case the source and target
  55.      should be the same, ie. "ln -r /foo /foo".
  56.  
  57. SSEEEE AALLSSOO
  58.      rm(1), cp(1), mv(1), link(2), readlink(2), stat(2), sym-
  59.      link(2)
  60.  
  61.  
  62.  
  63. Sprite v1.0             November 26, 1986                       1
  64.  
  65.  
  66.  
  67.